Skip to content

doc: document host OS and Python support matrix - #520

Open
blackboxsw wants to merge 1 commit into
canonical:mainfrom
blackboxsw:docs-support
Open

doc: document host OS and Python support matrix#520
blackboxsw wants to merge 1 commit into
canonical:mainfrom
blackboxsw:docs-support

Conversation

@blackboxsw

Copy link
Copy Markdown
Collaborator

PR Checklist

To ease the process of reviewing your PR, do make sure to complete the following checklist before submitting a pull
request.

  • I have added unit tests to cover the new behavior under ``tests/unit_tests/```
  • I have run tox -e format locally to automatically format my code before submitting
  • I have run tox -e docs locally ensuring that it passes before submitting
  • (if applicable) I have added a reference to issues that this PR relates to in the PR message (Refs GH-1234, Fixes GH-1234)
  • My commits are atomic and follow the convetional commit message format (https://www.conventionalcommits.org/en/v1.0.0/)

Description

A followup to #508 to better document our python support matrix and host OS for test runners.

Add docs/supported_platforms.md documenting that pycloudlib runs on Linux only, with Ubuntu 24.04 LTS (Python 3.12) and Ubuntu 26.04 LTS (Python 3.14) as the tested host environments. Wire the new page into the docs index toctree and add a brief "Supported platforms" blurb to the README linking to it.

The Ubuntu 26.04 LTS row is forward-looking: CI does not yet run on an ubuntu-26.04 runner and no py314 tox env exists yet. The documented minimum Python is 3.12, though pyproject.toml still declares requires-python = ">=3.8" so pip will permit install on older, untested versions.

No code or package metadata changes; docs-only.

Additional Context and Relevant Issues

Test Steps

tox -e docs

Add docs/supported_platforms.md documenting that pycloudlib runs on
Linux only, with Ubuntu 24.04 LTS (Python 3.12) and Ubuntu 26.04 LTS
(Python 3.14) as the tested host environments. Wire the new page into
the docs index toctree and add a brief "Supported platforms" blurb to
the README linking to it.

The Ubuntu 26.04 LTS row is forward-looking: CI does not yet run on an
ubuntu-26.04 runner and no py314 tox env exists yet. The documented
minimum Python is 3.12, though pyproject.toml still declares
requires-python = ">=3.8" so pip will permit install on older,
untested versions.

No code or package metadata changes; docs-only.
@blackboxsw
blackboxsw requested a review from rpocase July 24, 2026 23:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant